Figure link relations
=====================

This document defines a suite of five "figure" link
relations for use on the World Wide Web. These figure
relations can be used to transclude external media into the
context.

The mechanism is similar to the <object>, <img>, and
associated elements in HTML, with the difference that the
referenced media does not replace the hyperlink in the
browsing context, but is suitable for rendering nearby,
e.g. in the margin in visual media, or after the current
paragraph or section in all media.

When the media is referenced as e.g. part of an HTTP Link
header or HTML <link> element, the referenced media should
be displayed at the end of the rendered browsing context.
Whether the referenced media is rendered at all should also
be at the discretion of the user.


rel: application-figure
-----------------------

Refers to a resource with an available representation in
the 'application' media type subtree suitable for rendering
within the context. This relation is a refinement of the
'figure' relation.


rel: audio-figure
-----------------

Refers to a resource with an available representation in
the 'audio' media type subtree suitable for rendering
within the context. This relation is a refinement of the
'figure' relation.


rel: figure
-----------

Refers to a resource with an available representation
suitable for rendering within the context. This relation is
refined by the 'application-figure', 'audio-figure',
'image-figure', and 'video-figure' relations.


rel: image-figure
-----------------

Refers to a resource with an available representation in
the 'image' media type subtree suitable for rendering
within the context. This relation is a refinement of the
'figure' relation.


rel: video-figure
-----------------

Refers to a resource with an available representation in
the 'video' media type subtree suitable for rendering
within the context. This relation is a refinement of the
'figure' relation.


References
----------

Link relations are defined in _RFC 8288_, and registered at
the _IANA link relations registry_. Media types are defined
in _RFC 6838_. The HTTP Link header is defined by _RFC
8288_ Section 3, and HTML is defined by the _text/html_
media type.

https://datatracker.ietf.org/doc/html/rfc8288
https://www.iana.org/assignments/link-relations/link-relations.xhtml
https://datatracker.ietf.org/doc/html/rfc6838
https://datatracker.ietf.org/doc/html/rfc8288#section-3
https://www.iana.org/assignments/media-types/text/html
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